home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / bbsutil / pbnet17.zip / FMC252.ZIP / FMC.DOC < prev    next >
Text File  |  1994-07-02  |  27KB  |  565 lines
  1.   The Curier Fido mail creator (alias FMC) User's Guide
  2.  
  3.   Version 2.52, May 1994
  4.  
  5.   Copyright (c) 1994 Radu Hociung.
  6.  
  7.   ALL RIGHTS RESERVED.
  8.  
  9.  
  10.      FMC is Copyright (c) 1994 by Radu Hociung.
  11.  
  12.      No parts of the FMC software or this document may be copied in
  13.      part or in whole, except as provided by the License in the
  14.      following pages.
  15.  
  16.      This version of FMC is NOT public domain. It is FREEWARE,
  17.      Please refer to the license information in the following
  18.      pages.
  19.  
  20.      Other product names found throughout this document are
  21.      trademarks of various companies.
  22.  
  23.   o  Copyright and Proprietary Rights
  24.  
  25.      The FMC (aka Curier) software is owned by Radu Hociung, and is
  26.      protected by Canada copyright laws and international treaty
  27.      provisions. The FMC software contains valuable trade secrets
  28.      proprietary to Radu Hociung. You may not disassemble,
  29.      decompile, reverse engineer, or create any derivative works of
  30.      the software for any purpose other than making an adaptation
  31.      to the software as a normal step in configuring it for your
  32.      own personal use.
  33.  
  34.  
  35.   o  License and Restrictions
  36.  
  37.      Radu Hociung grants individuals an unlimited license to use
  38.      the freeware version of FMC.
  39.      FMC is not "public domain". It is "free" software.
  40.  
  41.      All users are granted an unlimited license to copy the
  42.      freeware version of FMC, subject to the above as well as the
  43.      following restrictions:
  44.  
  45.      -    FMC must be distributed in absolutely unmodified form in
  46.           its entirety, including all file names, program code,
  47.           documentation, and any related files. No other programs
  48.           or files may be included. The files may be distributed in
  49.           a compressed or library format.
  50.  
  51.      -    FMC may not be included in combination with any other
  52.           software or hardware product as an enticement or for any
  53.           other reason, without special permission from Radu
  54.           Hociung.
  55.  
  56.      -    No fee or payment may be charged or accepted for FMC.
  57.  
  58.  
  59.      Electronic bulletin board system operators (sysops) are
  60.      encouraged to post the freeware version of FMC on their BBS
  61.      for  downloading by their users, but only if the above
  62.      conditions are met and no special fee is charged to access FMC
  63.      files (a general fee may be charged to access the BBS).
  64.  
  65.      Non-profit User Groups may distribute the shareware version of 
  66.      FMC provided the above conditions are met. These User Groups 
  67.      may charge a nominal fee to cover the cost of the disk and
  68.      copying of the software.
  69.  
  70.   o  Warranty Disclaimer
  71.  
  72.      Radu Hociung makes no warranty of any kind, either express or
  73.      implied,including but not limited to implied warranties of
  74.      merchantability and fitness for a particular purpose, with
  75.      respect to this software and accompanying documentation.
  76.  
  77.      IN NO EVENT SHALL RADU HOCIUNG BE LIABLE FOR ANY DAMAGES
  78.      RESULTING  FROM THE USE OF THIS SOFTWARE, INCLUDING BUT NOT
  79.      LIMITED TO, DAMAGES FOR LOSS OF BUSINESS PROFITS, BUSINESS
  80.      INTERRUPTION, LOSS OF BUSINESS INFORMATION, INCIDENTAL OR
  81.      CONSEQUENTIAL DAMAGES, OR OTHER FINANCIAL LOSS ARISING OUT OF
  82.      THE USE OF OR INABILITY TO USE THIS PROGRAM, EVEN IF RADU
  83.      HOCIUNG HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
  84.  
  85.        Fido Message Creator (c) Radu Hociung 1994
  86.  
  87.        FMC (Fido Message Creator, alas Courier) is a sysop's utility,
  88.        aimed at Fido sysops, but also to sysops running Fido compatible
  89.        networks, or anywhere FrontDoor type MSG messages are used.
  90.  
  91.        It creates MSG files, without a user interface, so it can be run
  92.        from batch files, wherever there is a need for automatic message
  93.        creation, like in automated file distribution, announcements,
  94.        mail lists, etc. etc.
  95.  
  96.        It can also been run interactively, so you can input the fields
  97.        from the keyboard, or use file redirection, or even piping.
  98.  
  99.        It is also capable of asking for keyboard input only for certain
  100.        fields of the message, like names, addresses, subject lines,
  101.        message flags, etc, etc.
  102.  
  103.        Also, it is capable of setting ALL standard Fido message flags,
  104.        as well as the flags supported by FrontDoor 2.02+
  105.  
  106.        +++  FEATURES:
  107.  
  108.     o  Fully user configurable.
  109.     o  Multiple configurations supported.
  110.     o  Mailing list capable.
  111.     o  Keyword oriented configuration file.
  112.     o  Fully FrontDoor 2.02+ compatible.
  113.     o  .MSG and .PKT modes.
  114.     o  Conference mail capable.
  115.     o  Support for keyboard input, file redirection, or piping.
  116.     o  Configurable to-be-prompted-for fields.
  117.     o  User defined log file.
  118.     o  Support for ALL Fido flags, incl. FrontDoor's.
  119.     o  Inter-zone support.
  120.     o  Point support, both destination and origin.
  121.     o  Explicit network gateway routing supported.
  122.  +++++++++++++         The command line                  ++++++++++++++++
  123.  
  124.  
  125.         Call the Courier with:
  126.  
  127.                 FMC [config file] [/M:msg_body] [/R] [/P] [/?]
  128.  
  129.  
  130.         ALL parameters are optional. If none is specified, the software
  131.         will assume INTERACTIVE mode, asking for keyboard input.
  132.  
  133.         [config file]   *** OPTIONAL ***
  134.  
  135.         The file and path (if necessary) to the configuration file whose
  136.         format is described under "The configuration File"
  137.  
  138.         Example: FMC DEFAULT.CFG
  139.  
  140.         [/M:msg_body]  *** OPTIONAL ***
  141.  
  142.         It forces FMC to ignore the "MessageText" Variable in the config
  143.         file, and use the file 'msg_body' instead.
  144.  
  145.         Example:  FMC DEFAULT.CFG /M:C:\TEXTS\MSG_TEXT.TXT
  146.  
  147.         [/R]  *** OPTIONAL ***
  148.  
  149.         Forces REPETITIVE action of FMC. It is only valid if used with
  150.         a configuration file that contains at least ONE variable set to
  151.         "Ask". Otherwise it is ignored.
  152.  
  153.         FMC will cycle until there is no more input.
  154.  
  155.         Useful for mail list approaches.
  156.  
  157.         Example: FMC DEFAULT.CFG /R
  158.  
  159.         [/P]   Packet mode (enables PKT creation) *** OPTIONAL ***
  160.  
  161.         This tells FMC to pack all messages into a Fido Compatible PKT file.
  162.         It is a VERY powerful option, and makes FMC suitable for use with
  163.         Fido incompatible BBS packages. If enabled, the PKT origin and target
  164.         addresses **MUST** be present in the config file.
  165.  
  166.         Also, when active, FMC can be told to put the messages in any
  167.         conference area on the network, using the variable "Conference".
  168.         To send a message through Netmail in a PKT, leave the "Conference"
  169.         variable unset.
  170.  
  171.         [/?]  *** OPTIONAL ***
  172.  
  173.         You guessed it. This will display a brief help screen.
  174.  
  175.           INTERACTIVE mode:
  176.  
  177.         To invoke the INTERACTIVE mode, don't use any parameters:
  178.  
  179.  +++++++++++++          The Configuration File           ++++++++++++++++
  180.  
  181.    FMC can be used with a configuration file which provides all the data
  182.    necessary for message creating.
  183.    The keywords used in the configuration file are summarized in this
  184.    table, and their description follows them.
  185.  
  186.  ┌──────────────────────────────────────────────────────────────────────┐
  187.  │         Valid Keywords:   ... Case is irrelevant :)                  │
  188.  ├──────────────────────────────────────────────────────────────────────┤
  189.  │     FromUser            Name in By: field                            │
  190.  │                                                                      │
  191.  │     ToUser              Name in To: field                            │
  192.  │                                                                      │
  193.  │     Subject             Name in Re: field                            │
  194.  │                                                                      │
  195.  │     Flags               NOT OPTIONAL !  'Flags =' for  'no flags'    │
  196.  │                                                                      │
  197.  │     Origin              Fully qualified address ... Zone:Net/Node.Pt │
  198.  │